home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 12 / BBS in a box XII-1.iso / Files / System7 tools / M / Menu Grabber 1.1.1.sit / Menu Grabber 1.1.1 / Menu Grabber Help.rsrc / STR#_1026.txt < prev    next >
Encoding:
Text File  |  1994-04-12  |  6.0 KB  |  255 lines
  1. 
  2.  
  3. 
  4.  
  5. ‹
  6.  
  7. ‹
  8.  
  9. √•How Does Menu Grabber Work?
  10.  
  11. 
  12.  
  13. 
  14.  
  15. xAbout Menu Events
  16.  
  17. 
  18.  
  19. Á
  20.  
  21. Á
  22.  
  23. Á
  24.  
  25. 
  26.  
  27. When the Menu Events extension is installed on a Macintosh, all
  28.  
  29. high-level-event-aware applications running on that machine gain support
  30.  
  31. for Menu events.  Menu events are a class of Apple events which allow a
  32.  
  33. sender to query an application‚Äôs menus and menu items, and to select its
  34.  
  35. menu items.  (See the help file for the Menu Events extension to learn
  36.  
  37. more about the Apple event syntax for Menu events.)
  38.  
  39. 
  40.  
  41. 
  42.  
  43. 
  44.  
  45. In order for Menu events to work across an AppleTalk network, the target
  46.  
  47. machine and application must meet the following conditions:
  48.  
  49. ‚Ä¢  program linking started in Sharing Setup control panel
  50.  
  51. ‚Ä¢  program linking allowed to user or guest through Users & Groups
  52.  
  53. control panel
  54.  
  55. ‚Ä¢  remote program linking allowed through application‚Äôs Sharing dialog
  56.  
  57. ‚Ä¢  Menu Events extension installed
  58.  
  59. 
  60.  
  61. 
  62.  
  63. NOTE (technical, but important):  Even with remote program linking
  64.  
  65. allowed, most applications run in a mode where they will not permit user
  66.  
  67. interaction in response to an event from another machine.  Menu Events
  68.  
  69. always requests user interaction to make the target application active, as
  70.  
  71. it would normally be when it senses a menu selection.  Menu Events is
  72.  
  73. programmed to overcome this problem.  If you want to allow remote Menu
  74.  
  75. events (such as sent by Menu Grabber) to work on applications running in
  76.  
  77. the default kAEInteractWithLocal interaction mode, leave Menu Events
  78.  
  79. unlocked.  Otherwise, lock it using the Get Info dialog, so that applications
  80.  
  81. can decide for themselves whether to allow remote control.  This choice
  82.  
  83. does not affect the acceptance of Menu events by applications which are
  84.  
  85. running in the kAEInteractWithSelf (always reject) or kAEInteractWithAll
  86.  
  87. (always accept) interaction mode.
  88.  
  89. 
  90.  
  91. After installing the Menu Events extension on the target machine, you
  92.  
  93. must restart that machine to enable support for Menu events.  An icon
  94.  
  95. appears at startup to confirm that the extension has initialized
  96.  
  97. successfully.  The icon includes a little padlock if Menu Events has been
  98.  
  99. locked against remote senders.
  100.  
  101. 
  102.  
  103. 
  104.  
  105. 
  106.  
  107. xSelecting a Target Application
  108.  
  109. 
  110.  
  111. Once you have installed the Menu Events extension on the target machine,
  112.  
  113. you are ready to try Menu Grabber.  You may decide to run Menu Grabber
  114.  
  115. on the same machine, as a first test, but to be certain that Menu events
  116.  
  117. will work for a certain target application across the network, you should
  118.  
  119. also try grabbing its menus from another machine.
  120.  
  121. 
  122.  
  123. 
  124.  
  125. To grab an application‚Äôs menus, press the Grab‚Ķ button in the Menu
  126.  
  127. Grabber dialog, then select the zone, machine, and application you want.
  128.  
  129. If the machine‚Äôs name does not appear, check that it is connected to the
  130.  
  131. network, and that program linking is started.  If the application‚Äôs name
  132.  
  133. does not appear, check that it is open, and that remote program linking is
  134.  
  135. allowed in its Sharing dialog.  If you have to turn on remote program
  136.  
  137. linking, you must quit the application first.  If the check box remains
  138.  
  139. grayed out after quitting the application, and the application is neither
  140.  
  141. locked nor on an unwritable volume, it is likely that the application is not
  142.  
  143. high-level-event-aware ‚Äî in other words, it doesn‚Äôt support program
  144.  
  145. linking, and can‚Äôt be controlled by Menu Grabber.
  146.  
  147. 
  148.  
  149. Unfortunately, some applications, such as any version of Finder which
  150.  
  151. predates Power Macintosh (version 7.1.2), are programmed in such a
  152.  
  153. way as to ignore high-level events which they do not understand, such as
  154.  
  155. Menu events.  If it seems to be taking a long time to grab the application‚Äôs
  156.  
  157. menus, you can wait 30 seconds for the attempt to time out, or press
  158.  
  159. Command-Period to cancel the attempt.  A few other applications
  160.  
  161. (Microsoft‚Äôs, especially) actively prevent system event handlers from
  162.  
  163. working; you will recognize them by the error message, ‚ÄúThe target
  164.  
  165. application has prevented the usual handling of the Menu event.  Menu
  166.  
  167. events should not be used with this application.‚Äù
  168.  
  169. 
  170.  
  171. If all goes well, the Menu Grabber dialog changes to show that it has
  172.  
  173. grabbed the application‚Äôs menus, and the menu bar changes to match.  If
  174.  
  175. you are using a color display, the menu bar turns red, and all grabbed
  176.  
  177. menus have white titles and white-on-black items, to make it obvious that
  178.  
  179. these are not Menu Grabber‚Äôs own menus.
  180.  
  181. 
  182.  
  183. To select another application, repeat the procedure.  To revert to Menu
  184.  
  185. Grabber‚Äôs own menus, press the Revert button, or press Escape or
  186.  
  187. Command-Period.
  188.  
  189. 
  190.  
  191. 
  192.  
  193. 
  194.  
  195. xUsing Grabbed Menus
  196.  
  197. 
  198.  
  199. Having grabbed the menus of a target application, you can control that
  200.  
  201. application by pulling down menus and selecting menu items from within
  202.  
  203. Menu Grabber.  Meanwhile, the target application and its menus continue
  204.  
  205. to work as usual.
  206.  
  207. 
  208.  
  209. 
  210.  
  211. Menu Grabber faithfully reproduces hierarchical (cascade) menus,
  212.  
  213. Command-key shortcut equivalents, bullets and check marks, and styles
  214.  
  215. such as underlining and italics.  It does not reproduce icons attached to
  216.  
  217. menu items.  If it encounters a non-standard menu (one which uses a menu
  218.  
  219. definition function other than the standard system 'MDEF'), it substitutes
  220.  
  221. a menu containing a grayed-out item saying ‚Äúnon-standard menu.‚Äù
  222.  
  223. Keyboard, Help, and Application menus are never grabbed; selecting an
  224.  
  225. item from these menus does not cause a Menu event to be sent to the
  226.  
  227. target application.
  228.  
  229. 
  230.  
  231. Menu Grabber adds an extra disabled item to the bottom of each grabbed
  232.  
  233. menu, to show the menu ID.  This may help you if you are writing a
  234.  
  235. program or script to send a Menu event to the application.
  236.  
  237. 
  238.  
  239. The reproduction of the target application‚Äôs menu bar is static.  If you
  240.  
  241. need to bring it up to date, because menus may have been added or
  242.  
  243. deleted, or items enabled or disabled, you must repeat the grabbing
  244.  
  245. procedure.  The simple way to do this is to press the Return or Enter key
  246.  
  247. twice ‚Äî once to bring up the program selection dialog, and once to accept
  248.  
  249. the selection.
  250.  
  251. 
  252.  
  253. 
  254.  
  255.